home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cato / Xm / VirtualBindings.z / VirtualBindings
Text File  |  1998-10-20  |  40KB  |  529 lines

  1.  
  2.  
  3.  
  4.      VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss - Bindings for virtual mouse and key events
  10.  
  11.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  12.           This page documents version 1.2 of the Motif library.
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           The 1/Motif manual pages describe translations in terms of
  16.           _v_i_r_t_u_a_l _b_i_n_d_i_n_g_s, based on those described in the _O_S_F/_M_o_t_i_f
  17.           _S_t_y_l_e _G_u_i_d_e.  Mouse events are described in terms of _v_i_r_t_u_a_l
  18.           _b_u_t_t_o_n_s, and key events are described in terms of _v_i_r_t_u_a_l
  19.           _k_e_y_s.  The term _v_i_r_t_u_a_l implies that the events as described
  20.           do not necessarily correspond to a fixed set of X Window
  21.           System events.  Instead, virtual buttons and keys are linked
  22.           to actual events by means of virtual bindings.
  23.  
  24.         VVVViiiirrrrttttuuuuaaaallll MMMMooooddddiiiiffffiiiieeeerrrrssss
  25.           Both virtual buttons and virtual keys may contain _v_i_r_t_u_a_l
  26.           _m_o_d_i_f_i_e_r_s.  Each virtual modifier corresponds to one or more
  27.           actual modifiers.  The following table lists the bindings of
  28.           virtual modifiers to actual modifiers in 1/Motif:
  29.  
  30.                            VVVViiiirrrrttttuuuuaaaallll MMMMooooddddiiiiffffiiiieeeerrrr BBBBiiiinnnnddddiiiinnnnggggssss
  31.                       VVVViiiirrrrttttuuuuaaaallll MMMMooooddddiiiiffffiiiieeeerrrr   AAAAccccttttuuuuaaaallll MMMMooooddddiiiiffffiiiieeeerrrrssss
  32.                       ___________________________________
  33.                       MMMMAAAAlllltttt               MMMMoooodddd1111
  34.                       MMMMCCCCooooppppyyyy              CCCCttttrrrrllll
  35.                       MMMMCCCCttttrrrrllll              CCCCttttrrrrllll
  36.                       MMMMLLLLiiiinnnnkkkk              CCCCttttrrrrllll SSSShhhhiiiifffftttt
  37.                       MMMMMMMMoooovvvveeee              SSSShhhhiiiifffftttt
  38.                       MMMMSSSShhhhiiiifffftttt             SSSShhhhiiiifffftttt
  39.  
  40.           MMMMoooodddd1111 refers to the first modifier key.  1/Motif requires
  41.           that it correspond to either AAAAlllltttt or MMMMeeeettttaaaa.
  42.  
  43.           The virtual modifier MMMMAAAAnnnnyyyy indicates that any modifier can be
  44.           used.  If MMMMAAAAnnnnyyyy is not specified and the user presses an
  45.           actual modifier that is not explicitly included in a
  46.           translation, that modifier may prevent the translation from
  47.           being matched.
  48.  
  49.         VVVViiiirrrrttttuuuuaaaallll BBBBuuuuttttttttoooonnnnssss
  50.           Each virtual button corresponds to one or more actual button
  51.           event descriptions.  Each button event description contains
  52.           a button name and possibly modifiers.  These button event
  53.           descriptions, appropriately ordered and possibly further
  54.           modified, are used in translation tables.  The following
  55.           table lists the bindings of virtual buttons to actual button
  56.           event descriptions in 1/Motif:
  57.  
  58.                             VVVViiiirrrrttttuuuuaaaallll BBBBuuuuttttttttoooonnnn BBBBiiiinnnnddddiiiinnnnggggssss
  59.                      VVVViiiirrrrttttuuuuaaaallll BBBBuuuuttttttttoooonnnn   AAAAccccttttuuuuaaaallll BBBBuuuuttttttttoooonnnn EEEEvvvveeeennnnttttssss
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                      _____________________________________
  75.                      BBBBCCCCuuuussssttttoooommmm          <<<<BBBBttttnnnn3333>>>>
  76.                      BBBBDDDDrrrraaaagggg            <<<<BBBBttttnnnn2222>>>>
  77.                      BBBBEEEExxxxtttteeeennnndddd          SSSShhhhiiiifffftttt<<<<BBBBttttnnnn1111>>>>
  78.                      BBBBMMMMeeeennnnuuuu            <<<<BBBBttttnnnn3333>>>>
  79.                      BBBBSSSSeeeelllleeeecccctttt          <<<<BBBBttttnnnn1111>>>>
  80.                      BBBBTTTToooogggggggglllleeee          CCCCttttrrrrllll<<<<BBBBttttnnnn1111>>>>
  81.  
  82.         VVVViiiirrrrttttuuuuaaaallll KKKKeeeeyyyyssss
  83.           Each virtual key corresponds to one or more actual key event
  84.           descriptions.  Each key event description contains a keysym
  85.           name and possibly modifiers.  These key event descriptions,
  86.           appropriately ordered and possibly further modified, are
  87.           used in translation tables.  The following table lists the
  88.           bindings of virtual keys to actual key event descriptions in
  89.           1/Motif:
  90.  
  91.                               VVVViiiirrrrttttuuuuaaaallll KKKKeeeeyyyy BBBBiiiinnnnddddiiiinnnnggggssss
  92.                       ____________________________________
  93.                       VVVViiiirrrrttttuuuuaaaallll KKKKeeeeyyyy    AAAAccccttttuuuuaaaallll KKKKeeeeyyyy EEEEvvvveeeennnnttttssss
  94.                       ________________________________________________________________________
  95.                       KKKKAAAAccccttttiiiivvvvaaaatttteeee      <<<<KKKKeeeeyyyy>>>>RRRReeeettttuuuurrrrnnnn
  96.                                      CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>RRRReeeettttuuuurrrrnnnn
  97.                                      <<<<KKKKeeeeyyyy>>>>oooossssffffAAAAccccttttiiiivvvvaaaatttteeee
  98.                       ____________________________________
  99.                       KKKKAAAAddddddddMMMMooooddddeeee       <<<<KKKKeeeeyyyy>>>>oooossssffffAAAAddddddddMMMMooooddddeeee
  100.                       ____________________________________
  101.                       KKKKBBBBaaaacccckkkkSSSSppppaaaacccceeee     <<<<KKKKeeeeyyyy>>>>oooossssffffBBBBaaaacccckkkkSSSSppppaaaacccceeee
  102.                       ____________________________________
  103.                       KKKKBBBBaaaacccckkkkTTTTaaaabbbb       SSSShhhhiiiifffftttt<<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb
  104.                       ____________________________________
  105.                       KKKKBBBBeeeeggggiiiinnnnDDDDaaaattttaaaa     CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee
  106.                       ____________________________________
  107.                       KKKKBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee     <<<<KKKKeeeeyyyy>>>>oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee
  108.                       ____________________________________
  109.                       KKKKCCCCaaaannnncccceeeellll        <<<<KKKKeeeeyyyy>>>>oooossssffffCCCCaaaannnncccceeeellll
  110.                       ____________________________________
  111.                       KKKKCCCClllleeeeaaaarrrr         <<<<KKKKeeeeyyyy>>>>oooossssffffCCCClllleeeeaaaarrrr
  112.                       ____________________________________
  113.                       KKKKCCCCooooppppyyyy          <<<<KKKKeeeeyyyy>>>>oooossssffffCCCCooooppppyyyy
  114.                                      CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>oooossssffffIIIInnnnsssseeeerrrrtttt
  115.                       ____________________________________
  116.                       KKKKCCCCuuuutttt           <<<<KKKKeeeeyyyy>>>>oooossssffffCCCCuuuutttt
  117.                                      SSSShhhhiiiifffftttt<<<<KKKKeeeeyyyy>>>>oooossssffffDDDDeeeelllleeeetttteeee
  118.                       ____________________________________
  119.                       KKKKDDDDeeeelllleeeetttteeee        <<<<KKKKeeeeyyyy>>>>oooossssffffDDDDeeeelllleeeetttteeee
  120.                       ____________________________________
  121.                       KKKKDDDDeeeesssseeeelllleeeeccccttttAAAAllllllll   CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>bbbbaaaacccckkkkssssllllaaaasssshhhh
  122.                       ____________________________________
  123.                       KKKKDDDDoooowwwwnnnn          <<<<KKKKeeeeyyyy>>>>oooossssffffDDDDoooowwwwnnnn
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX))))
  137.  
  138.  
  139.  
  140.                       ____________________________________
  141.                       KKKKEEEEnnnnddddDDDDaaaattttaaaa       CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>oooossssffffEEEEnnnnddddLLLLiiiinnnneeee
  142.                       ____________________________________
  143.                       KKKKEEEEnnnnddddLLLLiiiinnnneeee       <<<<KKKKeeeeyyyy>>>>oooossssffffEEEEnnnnddddLLLLiiiinnnneeee
  144.                       ____________________________________
  145.                       KKKKEEEEnnnntttteeeerrrr         <<<<KKKKeeeeyyyy>>>>RRRReeeettttuuuurrrrnnnn
  146.                       ____________________________________
  147.                       KKKKEEEEssssccccaaaappppeeee        <<<<KKKKeeeeyyyy>>>>EEEEssssccccaaaappppeeee
  148.                       ____________________________________
  149.                       KKKKEEEExxxxtttteeeennnndddd        CCCCttttrrrrllll SSSShhhhiiiifffftttt<<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee
  150.                                      SSSShhhhiiiifffftttt<<<<KKKKeeeeyyyy>>>>oooossssffffSSSSeeeelllleeeecccctttt
  151.                       ____________________________________
  152.                       KKKKHHHHeeeellllpppp          <<<<KKKKeeeeyyyy>>>>oooossssffffHHHHeeeellllpppp
  153.                       ____________________________________
  154.                       KKKKIIIInnnnsssseeeerrrrtttt        <<<<KKKKeeeeyyyy>>>>oooossssffffIIIInnnnsssseeeerrrrtttt
  155.                       ____________________________________
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX))))
  203.  
  204.  
  205.  
  206.                         VVVViiiirrrrttttuuuuaaaallll KKKKeeeeyyyy BBBBiiiinnnnddddiiiinnnnggggssss ((((CCCCoooonnnnttttiiiinnnnuuuueeeedddd))))
  207.                     ________________________________________
  208.                     VVVViiiirrrrttttuuuuaaaallll KKKKeeeeyyyy     AAAAccccttttuuuuaaaallll KKKKeeeeyyyy EEEEvvvveeeennnnttttssss
  209.                     ________________________________________________________________________________
  210.                     KKKKLLLLeeeefffftttt           <<<<KKKKeeeeyyyy>>>>oooossssffffLLLLeeeefffftttt
  211.                     ________________________________________
  212.                     KKKKMMMMeeeennnnuuuu           <<<<KKKKeeeeyyyy>>>>oooossssffffMMMMeeeennnnuuuu
  213.                     ________________________________________
  214.                     KKKKMMMMeeeennnnuuuuBBBBaaaarrrr        <<<<KKKKeeeeyyyy>>>>oooossssffffMMMMeeeennnnuuuuBBBBaaaarrrr
  215.                     ________________________________________
  216.                     KKKKNNNNeeeexxxxttttFFFFiiiieeeelllldddd      <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb
  217.                                     CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb
  218.                     ________________________________________
  219.                     KKKKNNNNeeeexxxxttttMMMMeeeennnnuuuu       CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>oooossssffffDDDDoooowwwwnnnn
  220.                                     CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>oooossssffffRRRRiiiigggghhhhtttt
  221.                     ________________________________________
  222.                     KKKKPPPPaaaaggggeeeeDDDDoooowwwwnnnn       <<<<KKKKeeeeyyyy>>>>oooossssffffPPPPaaaaggggeeeeDDDDoooowwwwnnnn
  223.                     ________________________________________
  224.                     KKKKPPPPaaaaggggeeeeLLLLeeeefffftttt       CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>oooossssffffPPPPaaaaggggeeeeUUUUpppp
  225.                                     <<<<KKKKeeeeyyyy>>>>oooossssffffPPPPaaaaggggeeeeLLLLeeeefffftttt
  226.                     ________________________________________
  227.                     KKKKPPPPaaaaggggeeeeRRRRiiiigggghhhhtttt      CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>oooossssffffPPPPaaaaggggeeeeDDDDoooowwwwnnnn
  228.                                     <<<<KKKKeeeeyyyy>>>>oooossssffffPPPPaaaaggggeeeeRRRRiiiigggghhhhtttt
  229.                     ________________________________________
  230.                     KKKKPPPPaaaaggggeeeeUUUUpppp         <<<<KKKKeeeeyyyy>>>>oooossssffffPPPPaaaaggggeeeeUUUUpppp
  231.                     ________________________________________
  232.                     KKKKPPPPaaaasssstttteeee          <<<<KKKKeeeeyyyy>>>>oooossssffffPPPPaaaasssstttteeee
  233.                                     SSSShhhhiiiifffftttt<<<<KKKKeeeeyyyy>>>>oooossssffffIIIInnnnsssseeeerrrrtttt
  234.                     ________________________________________
  235.                     KKKKPPPPrrrreeeevvvvFFFFiiiieeeelllldddd      SSSShhhhiiiifffftttt<<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb
  236.                                     CCCCttttrrrrllll SSSShhhhiiiifffftttt<<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb
  237.                     ________________________________________
  238.                     KKKKPPPPrrrreeeevvvvMMMMeeeennnnuuuu       CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>oooossssffffUUUUpppp
  239.                                     CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>oooossssffffLLLLeeeefffftttt
  240.                     ________________________________________
  241.                     KKKKPPPPrrrriiiimmmmaaaarrrryyyyCCCCooooppppyyyy    CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>oooossssffffPPPPrrrriiiimmmmaaaarrrryyyyPPPPaaaasssstttteeee
  242.                                     MMMMoooodddd1111<<<<KKKKeeeeyyyy>>>>oooossssffffCCCCooooppppyyyy
  243.                                     MMMMoooodddd1111 CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>oooossssffffIIIInnnnsssseeeerrrrtttt
  244.                     ________________________________________
  245.                     KKKKPPPPrrrriiiimmmmaaaarrrryyyyCCCCuuuutttt     MMMMoooodddd1111<<<<KKKKeeeeyyyy>>>>oooossssffffPPPPrrrriiiimmmmaaaarrrryyyyPPPPaaaasssstttteeee
  246.                                     MMMMoooodddd1111<<<<KKKKeeeeyyyy>>>>oooossssffffCCCCuuuutttt
  247.                                     MMMMoooodddd1111 SSSShhhhiiiifffftttt<<<<KKKKeeeeyyyy>>>>oooossssffffDDDDeeeelllleeeetttteeee
  248.                     ________________________________________
  249.                     KKKKPPPPrrrriiiimmmmaaaarrrryyyyPPPPaaaasssstttteeee   <<<<KKKKeeeeyyyy>>>>oooossssffffPPPPrrrriiiimmmmaaaarrrryyyyPPPPaaaasssstttteeee
  250.                     ________________________________________
  251.                     KKKKQQQQuuuuiiiicccckkkkCCCCooooppppyyyy      CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>oooossssffffQQQQuuuuiiiicccckkkkPPPPaaaasssstttteeee
  252.                     ________________________________________
  253.                     KKKKQQQQuuuuiiiicccckkkkCCCCuuuutttt       MMMMoooodddd1111<<<<KKKKeeeeyyyy>>>>oooossssffffQQQQuuuuiiiicccckkkkPPPPaaaasssstttteeee
  254.                     ________________________________________
  255.                     KKKKQQQQuuuuiiiicccckkkkEEEExxxxtttteeeennnndddd    SSSShhhhiiiifffftttt<<<<KKKKeeeeyyyy>>>>oooossssffffQQQQuuuuiiiicccckkkkPPPPaaaasssstttteeee
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX))))
  269.  
  270.  
  271.  
  272.                     ________________________________________
  273.                         VVVViiiirrrrttttuuuuaaaallll KKKKeeeeyyyy BBBBiiiinnnnddddiiiinnnnggggssss ((((CCCCoooonnnnttttiiiinnnnuuuueeeedddd))))
  274.                      ______________________________________
  275.                      VVVViiiirrrrttttuuuuaaaallll KKKKeeeeyyyy   AAAAccccttttuuuuaaaallll KKKKeeeeyyyy EEEEvvvveeeennnnttttssss
  276.                      ____________________________________________________________________________
  277.                      KKKKQQQQuuuuiiiicccckkkkPPPPaaaasssstttteeee   <<<<KKKKeeeeyyyy>>>>oooossssffffQQQQuuuuiiiicccckkkkPPPPaaaasssstttteeee
  278.                      ______________________________________
  279.                      KKKKRRRReeeesssseeeelllleeeecccctttt     CCCCttttrrrrllll SSSShhhhiiiifffftttt<<<<KKKKeeeeyyyy>>>>oooossssffffSSSSeeeelllleeeecccctttt
  280.                      ______________________________________
  281.                      KKKKRRRReeeessssttttoooorrrreeee      CCCCttttrrrrllll SSSShhhhiiiifffftttt<<<<KKKKeeeeyyyy>>>>oooossssffffIIIInnnnsssseeeerrrrtttt
  282.                      ______________________________________
  283.                      KKKKRRRRiiiigggghhhhtttt        <<<<KKKKeeeeyyyy>>>>oooossssffffRRRRiiiigggghhhhtttt
  284.                      ______________________________________
  285.                      KKKKSSSSeeeelllleeeecccctttt       <<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee
  286.                                    CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee
  287.                                    <<<<KKKKeeeeyyyy>>>>oooossssffffSSSSeeeelllleeeecccctttt
  288.                      ______________________________________
  289.                      KKKKSSSSeeeelllleeeeccccttttAAAAllllllll    CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>ssssllllaaaasssshhhh
  290.                      ______________________________________
  291.                      KKKKSSSSppppaaaacccceeee        <<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee
  292.                      ______________________________________
  293.                      KKKKTTTTaaaabbbb          <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb
  294.                      ______________________________________
  295.                      KKKKUUUUnnnnddddoooo         <<<<KKKKeeeeyyyy>>>>oooossssffffUUUUnnnnddddoooo
  296.                                    MMMMoooodddd1111<<<<KKKKeeeeyyyy>>>>oooossssffffBBBBaaaacccckkkkSSSSppppaaaacccceeee
  297.                      ______________________________________
  298.                      KKKKUUUUpppp           <<<<KKKKeeeeyyyy>>>>oooossssffffUUUUpppp
  299.                      ______________________________________
  300.                      KKKKAAAAnnnnyyyy          <<<<KKKKeeeeyyyy>>>>
  301.                      ______________________________________
  302.  
  303.         BBBBiiiinnnnddddiiiinnnnggggssss ffffoooorrrr oooossssffff KKKKeeeeyyyyssssyyyymmmmssss
  304.           Keysym strings that begin with "osf" are not part of the X
  305.           server's keyboard mapping.  Instead, these keysyms are
  306.           produced on the client side at run time.  They are
  307.           interpreted by the routine XXXXmmmmTTTTrrrraaaannnnssssllllaaaatttteeeeKKKKeeeeyyyy, and are used by
  308.           the translation manager when the server delivers an actual
  309.           key event.  For each application, a mapping is maintained
  310.           between "osf" keysyms and keysyms that correspond to actual
  311.           keys.  This mapping is based on information obtained at
  312.           application startup from one of the following sources,
  313.           listed in order of precedence:
  314.  
  315.  
  316.             +o  A ddddeeeeffffaaaauuuullllttttVVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss application resource in the
  317.                resource database.
  318.  
  319.             +o  A property on the root window, which can be set by mmmmwwwwmmmm
  320.                on startup, or by the xxxxmmmmbbbbiiiinnnndddd client, or on prior
  321.                startup of a Motif application.
  322.  
  323.             +o  The file ....mmmmoooottttiiiiffffbbbbiiiinnnndddd in the user's home directory.
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 4/30/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX))))
  335.  
  336.  
  337.  
  338.             +o  A set of bindings based on the vendor string and
  339.                optionally the vendor release of the X server.  Motif
  340.                searches for these bindings in the following steps:
  341.  
  342.  
  343.                  -- If the file xxxxmmmmbbbbiiiinnnndddd....aaaalllliiiiaaaassss exists in the user's home
  344.                     directory, Motif searches this file for a pathname
  345.                     associated with the vendor string or with the
  346.                     vendor string and vendor release.  If it finds
  347.                     such a pathname and if that file exists, Motif
  348.                     loads the bindings contained in that file.
  349.  
  350.                  -- If it has found no bindings, Motif next looks for
  351.                     the file xxxxmmmmbbbbiiiinnnndddd....aaaalllliiiiaaaassss in the directory specified
  352.                     by the environment variable XXXXMMMMBBBBIIIINNNNDDDDDDDDIIIIRRRR, if
  353.                     XXXXMMMMBBBBIIIINNNNDDDDDDDDIIIIRRRR is set, or in the directory
  354.                     ////uuuussssrrrr////lllliiiibbbb////XXXXmmmm////bbbbiiiinnnnddddiiiinnnnggggssss if XXXXMMMMBBBBIIIINNNNDDDDDDDDIIIIRRRR is not set.  If
  355.                     this file exists Motif searches it for a pathname
  356.                     associated with the vendor string or with the
  357.                     vendor string and vendor release.  If it finds
  358.                     such a pathname and if that file exists, Motif
  359.                     loads the bindings contained in that file.
  360.  
  361.                  -- If it still has found no bindings, Motif loads a
  362.                     set of hard-coded fallback bindings.
  363.  
  364.  
  365.           The xxxxmmmmbbbbiiiinnnndddd....aaaalllliiiiaaaassss file contains zero or more lines of the
  366.           form:
  367.  
  368.           "_v_e_n_d_o_r__s_t_r_i_n_g[ _v_e_n_d_o_r__r_e_l_e_a_s_e]"_b_i_n_d_i_n_g_s__f_i_l_e
  369.  
  370.           where _v_e_n_d_o_r__s_t_r_i_n_g is the X server vendor name as  returned
  371.           by the X client xxxxddddppppyyyyiiiinnnnffffoooo or the Xlib function XXXXSSSSeeeerrrrvvvveeeerrrrVVVVeeeennnnddddoooorrrr,
  372.           and must appear in  double  quotes.   If  _v_e_n_d_o_r__r_e_l_e_a_s_e  is
  373.           included,  it  is  the  X  server  vendor  release number as
  374.           returned by the X  client  xxxxddddppppyyyyiiiinnnnffffoooo  or  the  Xlib  function
  375.           XXXXVVVVeeeennnnddddoooorrrrRRRReeeelllleeeeaaaasssseeee, and must also be contained within the double
  376.           quotes  separated   by   one   space   from   _v_e_n_d_o_r__s_t_r_i_n_g.
  377.           _v_e_n_d_o_r__r_e_l_e_a_s_e  is  provided  to allow support of changes in
  378.           keyboard hardware from a vendor, assuming  that  the  vendor
  379.           increments   the   release  number  to  flag  such  changes.
  380.           Alternatively, the vendor may simply  use  a  unique  vendor
  381.           string for each different keyboard.
  382.  
  383.           _b_i_n_d_i_n_g_s__f_i_l_e is the pathname of  the  file  containing  the
  384.           bindings  themselves.   It  can  be  a  relative or absolute
  385.           pathname.  If it it is a relative pathname, it  is  relative
  386.           to the location of the xxxxmmmmbbbbiiiinnnndddd....aaaalllliiiiaaaassss file.
  387.  
  388.           Comment lines in the xxxxmmmmbbbbiiiinnnndddd....aaaalllliiiiaaaassss file begin with !!!!.
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 4/30/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX))))
  401.  
  402.  
  403.  
  404.           The bindings found in either  the  ....mmmmoooottttiiiiffffbbbbiiiinnnndddd  file  or  the
  405.           vendor  mapping are placed in a property on the root window.
  406.           This  property  is  used  to  determine  the  bindings   for
  407.           subsequent Motif applications.
  408.  
  409.           On startup mmmmwwwwmmmm attempts to load the file ....mmmmoooottttiiiiffffbbbbiiiinnnndddd  in  the
  410.           user's  home  directory.   If this is unsuccessful, it loads
  411.           the vendor bindings  as  described  above.   It  places  the
  412.           bindings  it  loads in a property on the root window for use
  413.           by subsequent Motif applications.
  414.  
  415.           xxxxmmmmbbbbiiiinnnndddd loads bindings from a file if that file is  specified
  416.           on the command line.  If no file is specified on the command
  417.           line, it attempts to load the file ....mmmmoooottttiiiiffffbbbbiiiinnnndddd in the  user's
  418.           home directory.  If this fails, it loads the vendor bindings
  419.           as described above.  It places the bindings it  loads  in  a
  420.           property  on  the  root  window  for use by subsequent Motif
  421.           applications.
  422.  
  423.           The format of the specification for mapping "osf" keysyms to
  424.           actual  keysyms is similar to that of a specification for an
  425.           event translation.  The syntax is  specified  here  in  EBNF
  426.           notation using the following conventions:
  427.  
  428.           [_a]       Means either nothing or _a
  429.           {_a}       Means zero or more occurrences of _a
  430.  
  431.           Terminals are enclosed in double quotation marks.
  432.  
  433.           The syntax of an "osf" keysym binding  specification  is  as
  434.           follows:
  435.  
  436.           binding_spec   = {line "\n"} [line]
  437.           line           = virtual_keysym ":" key_event
  438.           key_event      = {modifier_name} "<Key>" actual_keysym
  439.           virtual_keysym = keysym
  440.           actual_keysym  = keysym
  441.           keysym         = A valid X11 keysym name that is
  442.                            mapped by XXXXSSSSttttrrrriiiinnnnggggTTTTooooKKKKeeeeyyyyssssyyyymmmm
  443.  
  444.           As with event translations, more specific event descriptions
  445.           must  precede  less  specific descriptions.  For example, an
  446.           event description for a key with a modifier must  precede  a
  447.           description for the same key without the same modifier.
  448.  
  449.           Following  is  an  example  of  a  specification   for   the
  450.           ddddeeeeffffaaaauuuullllttttVVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss resource in a resource file:
  451.  
  452.           *defaultVirtualBindings: \
  453.                osfBackSpace   :    <Key>BackSpace\n\
  454.                osfInsert      :    <Key>InsertChar\n\
  455.           ...
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 4/30/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX))))
  467.  
  468.  
  469.  
  470.                osfDelete      :    <Key>DeleteChar
  471.  
  472.  
  473.           The format of a ....mmmmoooottttiiiiffffbbbbiiiinnnndddd file  or  of  a  file  containing
  474.           vendor  bindings  is  the  same,  except  that  the  binding
  475.           specification for each keysym is placed on a separate  line.
  476.           The  example  specification  above  appears  as follows in a
  477.           ....mmmmoooottttiiiiffffbbbbiiiinnnndddd or vendor bindings file:
  478.  
  479.           osfBackSpace   :    <Key>BackSpace
  480.           osfInsert      :    <Key>InsertChar
  481.           ...
  482.           osfDelete      :    <Key>DeleteChar
  483.  
  484.  
  485.           The  following  table  lists  the  fixed  fallback   default
  486.           bindings for "osf" keysyms:
  487.  
  488.                   FFFFaaaallllllllbbbbaaaacccckkkk DDDDeeeeffffaaaauuuulllltttt BBBBiiiinnnnddddiiiinnnnggggssss ffffoooorrrr """"oooossssffff"""" KKKKeeeeyyyyssssyyyymmmmssss
  489.                   """"oooossssffff"""" KKKKeeeeyyyyssssyyyymmmm       FFFFaaaallllllllbbbbaaaacccckkkk DDDDeeeeffffaaaauuuulllltttt BBBBiiiinnnnddddiiiinnnngggg
  490.                   ____________________________________________
  491.                   oooossssffffAAAAccccttttiiiivvvvaaaatttteeee        <<<<uuuunnnnbbbboooouuuunnnndddd>>>>
  492.                   oooossssffffAAAAddddddddMMMMooooddddeeee         SSSShhhhiiiifffftttt FFFF8888
  493.                   oooossssffffBBBBaaaacccckkkkSSSSppppaaaacccceeee       BBBBaaaacccckkkkssssppppaaaacccceeee
  494.                   oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee       HHHHoooommmmeeee
  495.                   oooossssffffCCCClllleeeeaaaarrrr           CCCClllleeeeaaaarrrr
  496.                   oooossssffffCCCCooooppppyyyy            <<<<uuuunnnnbbbboooouuuunnnndddd>>>>
  497.                   oooossssffffCCCCuuuutttt             <<<<uuuunnnnbbbboooouuuunnnndddd>>>>
  498.                   oooossssffffDDDDeeeelllleeeetttteeee          DDDDeeeelllleeeetttteeee
  499.                   oooossssffffDDDDoooowwwwnnnn            DDDDoooowwwwnnnn
  500.                   oooossssffffEEEEnnnnddddLLLLiiiinnnneeee         EEEEnnnndddd
  501.                   oooossssffffCCCCaaaannnncccceeeellll          EEEEssssccccaaaappppeeee
  502.                   oooossssffffHHHHeeeellllpppp            FFFF1111
  503.                   oooossssffffIIIInnnnsssseeeerrrrtttt          IIIInnnnsssseeeerrrrtttt
  504.                   oooossssffffLLLLeeeefffftttt            LLLLeeeefffftttt
  505.                   oooossssffffMMMMeeeennnnuuuu            FFFF4444
  506.                   oooossssffffMMMMeeeennnnuuuuBBBBaaaarrrr         FFFF11110000
  507.                   oooossssffffPPPPaaaaggggeeeeDDDDoooowwwwnnnn        NNNNeeeexxxxtttt
  508.                   oooossssffffPPPPaaaaggggeeeeLLLLeeeefffftttt        <<<<uuuunnnnbbbboooouuuunnnndddd>>>>
  509.                   oooossssffffPPPPaaaaggggeeeeRRRRiiiigggghhhhtttt       <<<<uuuunnnnbbbboooouuuunnnndddd>>>>
  510.                   oooossssffffPPPPaaaaggggeeeeUUUUpppp          PPPPrrrriiiioooorrrr
  511.                   oooossssffffPPPPaaaasssstttteeee           <<<<uuuunnnnbbbboooouuuunnnndddd>>>>
  512.                   oooossssffffPPPPrrrriiiimmmmaaaarrrryyyyPPPPaaaasssstttteeee    <<<<uuuunnnnbbbboooouuuunnnndddd>>>>
  513.                   oooossssffffQQQQuuuuiiiicccckkkkPPPPaaaasssstttteeee      <<<<uuuunnnnbbbboooouuuunnnndddd>>>>
  514.                   oooossssffffRRRRiiiigggghhhhtttt           RRRRiiiigggghhhhtttt
  515.                   oooossssffffSSSSeeeelllleeeecccctttt          SSSSeeeelllleeeecccctttt
  516.                   oooossssffffUUUUnnnnddddoooo            UUUUnnnnddddoooo
  517.                   oooossssffffUUUUpppp              UUUUpppp
  518.  
  519.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  520.           xxxxmmmmbbbbiiiinnnndddd((((1111XXXX))))
  521.  
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 4/30/98)
  526.  
  527.  
  528.  
  529.